home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 26.zip / BS1 part 26 / Qback 3.0 + superback 1.0.adf / ReadMe! < prev    next >
Text File  |  1992-12-11  |  12KB  |  241 lines
  1.  
  2.         Quarterback V3.0 Release Notes
  3.  
  4.               December 7, 1988
  5.  
  6. Thank you for purchasing Quarterback.  We have put a lot of effort into 
  7. making Quarterback as reliable as possible.  We made some last-minute 
  8. changes to it after the manual was printed, and we noticed a few things 
  9. which are not clearly explained in the manual.  We suggest that you print
  10. these notes and keep a copy with your Quarterback manual.
  11.  
  12. If you call us for support, please have your serial number and version
  13. number ready.  The serial number is on the Quarterback master diskette
  14. label.  The version number appears in the title bar of the Quarterback 
  15. window.  Be sure to send us your postage-paid warranty card.  It costs
  16. you only a few seconds of your time, but we are much more receptive
  17. to your call if your card is already in our files.  Our business hours
  18. are 8:30AM to 5:00PM Pacific time.  
  19.  
  20.  
  21. GENERAL NOTES
  22.  
  23. In our own testing of Quarterback, we can backup a full 20MB CLtd hard disk 
  24. in about 40 minutes in the fastest mode (write verification disabled and
  25. archive bits not set).  Your results may vary, depending on the speed of
  26. your hard drive and the degree of fragmentation of your files.
  27.  
  28. Quarterback stores its parameter file, QB.OPT, in the S: directory.  This
  29. directory is normally found on the Workbench disk in DF0.  Most hard disk 
  30. users use the AmigaDOS ASSIGN command to assign the S: subdirectory to their
  31. hard disk.  You may wish to add this command to your startup-sequence. 
  32. Otherwise, you may be asked to put your Workbench disk back into a drive so 
  33. that Quarterback can find the parameter file.  After you have begun a 
  34. restore operation using DF0, and Quarterback has already taken over DF0, you 
  35. will not be able to use DF0 to access the S: subdirectory.  In this case you 
  36. must wait until after you have completed the restore in order to save your 
  37. options.
  38.  
  39. We have added a new option for both backup and restore which allows you to 
  40. write the archive/restoration report to disk instead of printing it.  If you
  41. specify "disk" as the destination of the report, Quarterback asks for the
  42. device and path to the directory into which you want the report written.  You
  43. can specify any valid AmigaDOS device and path.  The device:path you specify 
  44. is saved  along with the other options, and is automatically restored when 
  45. you invoke Quarterback.  If you do not specify a device:path for the report, 
  46. it is  written to the device and directory which is current when you start
  47. Quarterback.
  48.  
  49. If you are a "power user" and you wish to use Quarterback without going 
  50. through all of the normal Quarterback dialog, you may wish to invoke
  51. Quarterback from CLI with a parameter file, as described in the Quarterback
  52. manual.  Quarterback can also be invoked with parameters via the CLI command
  53. line, which is not described in the manual.  Command line parameters are the 
  54. same as for a command file.  The INCLUDEALL and EXCLUDEALL keywords defined 
  55. in the Quarterback manual have been eliminated.  Instead, the INCLUDE and
  56. EXCLUDE keywords accept a parameter of ALL for the file name.  Therefore, you
  57. cannot INCLUDE or EXCLUDE a file named ALL in a command file or on the 
  58. command line.
  59.  
  60. For example, to invoke Quarterback to backup word processing documents which
  61. have changed since the last backup in subdirectory WP on DH0, you would
  62. type:
  63.  
  64.         QUARTERBACK BACKUP DH0:WP EXCLUDE ALL ARCHIVE
  65.  
  66. Command line or command file parameters can be in any order, but are executed
  67. in the order listed.  Some keywords make no sense if executed in the wrong
  68. order.  So be sure that you consider the effects of each keyword as you 
  69. decide the order to enter them.  For example, it makes no sense to follow 
  70. DATE xx-mmm-yy with INCLUDE ALL.
  71.  
  72. The maximum path length supported by Quarterback is 256 characters, including
  73. the device/volume name.
  74.  
  75. Gadgets for selecting the floppy disk drives have been changed on the
  76. BACKUP OPTIONS screen and removed from the RESTORE OPTIONS screen.  Backup
  77. and restore now support the use of DF0, DF1, DF2, or DF3.  Backup can use 
  78. one or two drives.  Restore uses only a single drive.
  79.  
  80. Menu items are disabled when the backup or restore is active.  If you think 
  81. you may need another CLI, open it before you proceed from the Options window.
  82.  
  83. Quarterback does NOT support the full wild card options of AmigaDOS.  Wild 
  84. cards are limited to ? anywhere in a name, and #? appearing ONCE in a name, 
  85. such as:
  86.  
  87.         #GA?E?.c 
  88. or 
  89.         files#?
  90.  
  91. Abort gadgets appear on several screens in Quarterback.  Quarterback checks
  92. the abort gadget periodically, usually when it has finished performing
  93. some major activity, such as backing up or restoring an entire file.  Thus,
  94. if you click on an abort gadget you may not see any response for several
  95. seconds.  The natural temptation is to click a few more times to "wake up"
  96. Quarterback.  This may create undesirable actions, since the extra clicks
  97. are usually saved, and may be acted upon in order when Quarterback finally 
  98. looks for them.  When Quarterback sends a report to the printer, the printer
  99. usually holds many lines of text in its buffer.  Therefore, if you abort
  100. a report, the printer may continue to print for some time before stopping.
  101.  
  102. Don't remove Quarterback disks while the drive light is on.  And be sure to
  103. remove Quarterback disks when warned.  AmigaDOS doesn't like Quarterback 
  104. disks.  
  105.  
  106. Disks formatted by Quarterback can be copied/verified using the AmigaDOS
  107. Diskcopy utility.
  108.  
  109. Quarterback has very low overhead per file.  The catalog entry is about 25
  110. bytes per file (depending on the length of the file name and possible file
  111. comments).  There is a 14-byte ID per disk drive.  Each file is stored as 
  112. pure data.  No compression is used, other than the fact that Quarterback has
  113. much lower overhead per file than AmigaDOS, and consequently is able to store
  114. more useful data per floppy than AmigaDOS.
  115.  
  116.  
  117. BACKUP NOTES
  118.  
  119. If you have partitioned your hard disk, you must backup or restore each
  120. partition as a different device.
  121.  
  122. When Quarterback builds a catalog of files to backup it automatically 
  123. scans down through all levels of the directory tree structure, starting at 
  124. the device or device/path that you specify.  If you wish to include files 
  125. from any directory on a drive, you should specify just the device itself, 
  126. so that Quarterback can scan from the root directory down through all levels
  127. of the structure.  If you know that you want only files from a single 
  128. directory and nothing else, you should specify the full device/path to that
  129. directory.
  130.  
  131. When Quarterback has built the complete catalog, you can then select the
  132. individual files or groups of files to be included in (or excluded from) the
  133. backup.  All files are "included" when Quarterback first displays the 
  134. catalog.  If you wish only to backup one or two files, you should first
  135. "exclude" all files, then "include" only the ones you really want.  You can
  136. move down or up the tree, including or excluding files as you wish, until you
  137. have identified all files to be processed.  Then you are ready to proceed 
  138. with the backup.
  139.  
  140. A new option affecting how subdirectories are backed up has been added to the
  141. BACKUP OPTIONS screen.  It is:
  142.  
  143.     Backup full subdirectory structure:  YES  NO
  144.  
  145. If you select YES, Quarterback includes all subdirectories in the backup
  146. catalog, even if a subdirectory is empty (contains no files or other sub-
  147. directories).  This takes up only a little more room in the catalog of the
  148. first backup disk, but makes it possible for you to restore the empty sub-
  149. directories, if you wish (using the Restore Full Subdirectory Structure 
  150. option described below).  You might want to do this if you are performing a
  151. full restore to a replacement disk drive, and you want the restored disk to
  152. have the exact same directory structure as the original drive.
  153.  
  154. If you select NO, Quarterback includes only those subdirectories in the
  155. backup catalog which contain files or other subdirectories to be backed up.  
  156.  
  157. Quarterback can now use any of the standard floppy drives, DF0-DF3, for
  158. backup.  Any pair of these drives is also valid.  However, no more than
  159. two floppies can be used for backup.
  160.  
  161. During backup, Quarterback writes a unique identification code to each disk,
  162. including a sequence number and the date and time of the backup.  On restore,
  163. Quarterback checks each disk for the proper sequence number, and the date and
  164. time.  The date/time stamp allows Quarterback to detect intermixing of disks
  165. from different sets of backups.
  166.  
  167. Quarterback can be directed to read each track of the backup disks after 
  168. writing.  If Quarterback finds an unusable track on a disk during backup, it
  169. warns you and asks you to replace the bad disk with another disk.  It then
  170. resets itself to the beginning of that disk and continues.  The new disk
  171. replaces the bad disk in its entirety.  You need not retain the bad disk.
  172.  
  173. You CANNOT overwrite an individual file on an existing set of backup disks. 
  174. Each backup operation completely erases any previous data on a set of disks. 
  175. Quarterback does NOT allow you to "add" more files to an existing backup set 
  176. of disks.  The "incremental" backup mode always produces a new set of disks
  177. which contain only those files which have changed since some previous backup. 
  178. When you perform an incremental backup you must also retain the previous set 
  179. of backup disks.
  180.  
  181. Quarterback may encounter illegal file names, such as "*" when it builds the 
  182. catalog of files.  Such file names cannot be processed by Quarterback, and
  183. are automatically excluded from the catalog and from the backup.
  184.  
  185. If Quarterback cannot open a file or detects a read error in a file during 
  186. the backup, it fills the space allocated for the file on the backup disk 
  187. with random data, warns you with a message on the screen, and marks the file 
  188. name with *** ERROR *** on the archive report.  However, the file does 
  189. appear in the backup catalog, even though the data in the file is useless.  
  190. This happens because the catalog is written to the first diskette, long 
  191. before Quarterback discovers the problem.  If you attempt to restore such a 
  192. file, you will find the contents useless.  During restore, you should
  193. exclude any files which are marked *** ERROR *** on the backup report.
  194.  
  195.  
  196. RESTORE NOTES
  197.  
  198. Quarterback now restores comments, protection bits, and the date/time stamp 
  199. on all files AND directories.
  200.  
  201. The restore option called "Create Subdirectories, as necessary" has been
  202. eliminated.  In its place you will find a new restore option affecting the 
  203. way empty subdirectories are handled.  It is:
  204.  
  205.     Restore full subdirectory structure:  YES  NO
  206.  
  207. If you are restoring to a device/path which already has a subdirectory
  208. structure which matches the catalog on the backup disks, this option has 
  209. no effect.
  210.  
  211. If you select YES, Quarterback restores all subdirectories found in the
  212. backup catalog, even if the new subdirectory will be empty.  
  213.  
  214. If you select NO, Quarterback restores only those subdirectories which
  215. contain files marked for restoration.  
  216.  
  217. You should set this option to "NO" if you are restoring just a few files to a
  218. device which already has the desired subdirectory structure in place.  
  219. Specify "NO" to avoid creating a bunch of empty directories which are of no 
  220. use to you.  Creating all those empty subdirectories can takes many minutes.
  221. User beware!
  222.  
  223. If you restore to a different subdirectory on the same device, you may run 
  224. out of room on that device, especially if you specify that the full sub-
  225. directory structure is to be restored.
  226.  
  227. Restore uses only a single floppy drive, with no automatic switching of
  228. floppy disk drives.  You can use any one of the available floppy drives for 
  229. the restore, but only one.  Our reasoning for this limit is that restore is 
  230. a critical process, and even though it may take some time, you should give 
  231. it your total attention.  Quarterback performs many error checks during 
  232. restore.  If it finds an error, the recovery from that error is much more 
  233. complicated if there are two floppy drives involved, both for the user
  234. and the program.
  235.  
  236. For restore, we have moved the floppy drive option from the options screen
  237. to the device screen, so that Quarterback can know which disk drive to use
  238. for reading the catalog, which is stored on the first disk of the backup
  239. set.
  240.  
  241. We have added an a